Internet Engineering Task Force (IETF) S. Bosch 
Request for Comments: 8438 Dovecot Oy 
Category: Standards Track August 2018 
ISSN: 2070-1721 


IMAP Extension for STATUS=SIZE 


Abstract 
This document adds a new capability called "STATUS=SIZE" to the 
Internet Message Access Protocol (IMAP). It allows retrieving the 
total storage size of a mailbox with a single STATUS command rather 
than retrieving and summing the sizes of all individual messages in 
that mailbox. 
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1. Introduction 


This document extends the Internet Message Access Protocol (IMAP) 
[IMAP4rev1] with a new capability called "STATUS=SIZE". To determine 
the total storage size of a mailbox, an IMAP client currently needs 
to retrieve all message sizes individually using the FETCH command 
with the RFC822.SIZE data item. The STATUS=SIZE capability provides 
a more efficient means of achieving this. It extends the STATUS 
command with a new "SIZE" data item, which indicates the total size 
of all messages in the target mailbox. This way, this information 
can be queried with just one STATUS command. When the LIST-STATUS 
IMAP capability [LIST-STATUS] is also available, the SIZE data item 
can be queried for many mailboxes at once using just one LIST 
command. 


This capability is particularly useful for IMAP clients that do not 
cache the state of the message store, such as most webmail clients. 
Without the "STATUS=SIZE" capability, such clients need to fetch all 
message sizes from the server when the size of an individual mailbox 
needs to be determined. For example, a user may request detailed 
quota usage information for each mailbox to find out which specific 
mailboxes consume most of the available storage resources. Using 
this information, the user can get an overview of which mailboxes 
need to be cleaned up to reduce quota usage. The QUOTA capability 
[QUOTA] is no help in that scenario, since the provided QUOTAROOT 
command can only yield the STORAGE resource usage of a whole quota 
root, not each individual mailbox within that root. 
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Conventions Used in This Document 


In examples, "C:" indicates lines sent by a client that is connected 
to a server. "S:" indicates lines sent by the server to the client. 


The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", “SHALL NOT", 
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and 
"OPTIONAL" in this document are to be interpreted as described in 

BCP 14 [KEYWORDS] [KEYWORDS2] when, and only when, they appear in all 
capitals, as shown here. 


STATUS Command and Response Extensions 


This extension defines one new status data item for the STATUS 
command and response: 


SIZE 
The total size of the mailbox in octets. This is not strictly 
required to be an exact value, but it MUST be equal to or greater 
than the sum of the values of the RFC822.SIZE FETCH message data 
item [IMAP4rev1] of all messages in the mailbox. When the QUOTA 
capability [QUOTA] is also supported, this value SHOULD be equal 
to the storage usage value used to enforce the STORAGE resource 
limit for this mailbox. This way, the client can directly infer 
the quota usage. 


Since the total storage size of a mailbox can easily exceed 4 GB, 
clients MUST be capable of receiving 63-bit SIZE data item values. 
The message size is chosen to be at most 63 bits wide rather than 64 
bits to make implementations on various platforms (such as Java) 


easier. 


Example: 


C: A01 STATUS frop (MESSAGES SIZE UIDNEXT) 
S: * STATUS frop (MESSAGES 8 SIZE 44421 UIDNEXT 242344) 
S: A01 OK STATUS completed 
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The same information can be obtained by using the following commands, 
albeit less efficiently: 


A02 SELECT "frop" 


+ + + + F F F 


FETCH 


1 FETCH 
FETCH 
FETCH 
FETCH 


FETCH 


+ + FF F F HF F 
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FETCH 


2 
3 
4 
5 
6 FETCH 
7 
8 
3 OK Fetch completed. 


FLAGS (\Answered \Flagged \Deleted \Seen \Draft) 
8 EXISTS 
1 RECENT 
OK [UNSEEN 7] First unseen. 

OK [UIDVALIDITY 1364851417] UIDs valid 
OK [UIDNEXT 242344] Predicted next UID 
OK [HIGHESTMODSEQ 3914] Highest 

A02 OK [READ-WRITE] 
FETCH 


Select completed. 


1:* (RFC822.SIZE) 


(RFC822 
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RFC822. 
RFC822. 
RFC822. 


RFC822. 
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- SIZE 
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When the LIST-STATUS IMAP 
the STATUS command can be 
improve efficiency. 
queried with just one LIST command. 


Example: 


A04 LIST 
* LIST () 
* STATUS 
* LIST () 
* STATUS 


NNNnNNWNA 


Bosch 


"" % RETURN 


This 


" A " " INBOX " 
(MESSAGES 17 SIZE 16234) 


"INBOX" 


" " 


" frop" 


3224) 
1222) 
444) 
4516) 
544) 
922) 
31126) 
2423) 


capability [LIST-STATUS] is also available, 
combined with the LIST command to further 
way, the sizes of many mailboxes can be 


(STATUS (MESSAGES SIZE)) 


"frop" (MESSAGES 8 SIZE 44421) 


A04 OK List completed. 
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4. 


Formal Syntax 


The following syntax specification augments the grammar specified in 
[IMAP4rev1] and [IMAP4-ABNF]. It uses the Augmented Backus-Naur Form 
(ABNF) notation as specified in [ABNF]. Elements not defined here 
are taken from [IMAP4rev1] and [IMAP4-ABNF]. 


capability =/ "STATUS=SIZE" 
status-att =f "SIZE" 
status-att-val =/ "SIZE" SP number64 


number64 = 1*DIGIT 
; Unsigned 63-bit integer 
; (0 <= n <= 9,223,372,036,854,775,807) 


Security Considerations 


There are no known additional security issues with this extension 
beyond those described for the base protocol [IMAP4rev1] and the 
LIST-STATUS extension [LIST-STATUS]. 


IANA Considerations 


IANA has added "STATUS=SIZE" to the "IMAP Capabilities" registry 
located at <http://www.iana.org/assignments/imap-capabilities>. 
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